home *** CD-ROM | disk | FTP | other *** search
/ Complete Internet Archive / Complete Internet Archive.iso / Web Boards / WebForum_tar(2).Z / WebForum_tar(2) / WebForum / README < prev    next >
Encoding:
Text File  |  1995-01-23  |  3.1 KB  |  76 lines
  1.  
  2.  
  3.     WebForum: yet another system usenet look-alike for the WWW
  4.                    version 1.6
  5.  
  6. As if WIT and HyperNews aren't enough, here's another system for providing
  7. a Usenet look-alike on the Web. Why, oh why, I hear you ask. 
  8.  
  9. Well, I wanted something more controllable than seemed to be offered.  I
  10. wanted to only allow registered users to use the system, that particular
  11. forums could have access further restricted to subsets of users, and that
  12. all of this could be implemented without using server-side includes.  I also
  13. wanted to have a simple make package, and administration through the web
  14. itself (so I could remotely administrate).
  15.  
  16. Really, I wanted to have software to do mailing list like things, but over
  17. the Web. The "news" metaphor follows naturally from what one can do with
  18. the Web.
  19.  
  20. My base system is at:
  21.  
  22.     http://issco-www.unige.ch/WebForum/
  23.  
  24. There is a guest account (name "guest", password "guest") for browsing
  25. around.
  26.  
  27. 1. INSTALLATION
  28. ===============
  29.  
  30. To install the system on your own machine, edit the Makefile to reflect
  31. your site, then type make. At the moment, I presume NCSA httpd (for
  32. security handling).
  33.  
  34.  
  35. 2. WebForum Administration
  36. ==========================
  37.  
  38. Administration is handled via the Web as well.  There is a file (admin.html)
  39. which will normally reside in the database directory
  40. (WebForum/.dbase/admin.html).  From here, you can add/delete
  41. users/groups/forums, etc.
  42.  
  43. 3. Mailing-List Gateways
  44. ========================
  45.  
  46. WebForum is also able to act as a gateway to mailing lists.  This is done by
  47. having an auxiliary post method associated with a forum, so that when a
  48. message is posted to the forum, the auxillary method is called as well.  An
  49. example of this is the SMail.pl program in the src directory.  This program
  50. should be called with an argument that is the address to mail the message to.
  51. To find out the details, study the mkmsg.pl script.
  52.  
  53. The other side of the gateway should be handled by a custom made script that
  54. grabs (say) a digest and posts it to the forum.  An example of this is the
  55. BMWdigest2WF script in the src directory. This script (on my system) grabs
  56. a BMW mailing list digest, and splits it out to the BMW forum. It does not
  57. take messages sent by my mailing agent (isscowww) since a loop would occur
  58. otherwise. The script is called periodically by crontab from the
  59. "getnewdigests" command (also in the src directory).
  60.  
  61. 4. Message Expiry and Archiving
  62. ===============================
  63.  
  64. The script "src/expire.pl" is a small program that "expires" old messages.
  65. I call it once a day from crontab. If you wish to archive messages as you
  66. expire them, then change that script to reflect your archiving method.
  67.  
  68. --------------------------------------------------------------------
  69. Afzal Ballim             | Internet: afzal@divsun.unige.ch
  70. ISSCO, University of Geneva  | X400: S=afzal;OU=divsun;O=unige;
  71. 54 route des Acacias         |       PRMD=switch;ADMD=arcom;C=ch
  72. CH-1227 GENEVA (Switzerland) | UUCP: mcvax!cui!divsun.unige.ch!afzal
  73. Tel: +41/22/705 71 12        | FAX: +41/22/300 10 86
  74. http://issco-www.unige.ch/   | http://issco-www.unige.ch/WebForum
  75. ``I'm not artificially intelligent, I just work that way.''
  76.